home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / compress / av704.zip / AV.DOC next >
Text File  |  1997-04-28  |  11KB  |  248 lines
  1. AV.DOC                                 1                           Apr 28, 1997
  2.  
  3. The AV.EXE program shows a directory of one or more archive  files  (ZIP,  ZOO,
  4. etc), including some self-extracting files.  Features of this program:
  5.  
  6.   * The directory information is presented in full-screen mode and you can  use
  7.     PgUp and PgDn to scroll about the screens.
  8.   * Allows you to sort the display of the members in a number of ways.
  9.   * Allows you to reset the file date of the archive to match the date  of  the
  10.     most recent member of the archive.
  11.   * Provides the ability to filter out what members are displayed.
  12.   * Scroll through up to 500 archives.
  13.   * The date format shown is based on your country setting.
  14.   * Supports 43/50-line mode under EGA and VGA.
  15.   * Quick in-memory display for up to 50  archive  members;  bullet-proof  ISAM
  16.     support if it goes beyond that.
  17.  
  18.  
  19. A typical display might look (in part) like the following:
  20.  
  21. AV602.ZIP         Date      Time  OrigSize Method    NowSize  %reduce
  22. ------------  --------  -------- --------- -------- --------  -------[PgUp]
  23. AV.DOC        96/02/04  18:32:36      8585 Deflated     3395    61   [PgDn]
  24. AV.EXE        96/02/11  11:09:56    166744 Deflated   107879    36   [Home]
  25. BRUCE602.DOC  96/02/05  20:31:56     32493 Deflated    12566    62   [End]
  26. BRUCEINI.DOC  96/01/20  16:09:18      7649 Deflated     2891    63   [Up]
  27. FILE_ID.DIZ   96/01/28  12:26:36       214 Deflated      191    11   [Down]
  28.                                                                      [Sort]
  29.                                                                        [Name]
  30.                                                                        [Ext]
  31.                                                                        [Date]
  32.                                                                        [Size]
  33.                                                                        [CurSize
  34.                                                                        [Ratio]
  35.                                                                        [Path]
  36.                                                                        [Orig]
  37.                                                                        [-Flip]
  38.                                                                      [Filter]
  39.                                                                      [C-PgDn]
  40.                                                                      [C-PgUp]
  41.                                                                      [Quit]
  42.  
  43. ============  ========  ======== ========= ======== ========  =======[Help]
  44.  *5           96/02/11  11:09:56    215685            126922    42%  [Date]
  45. AV602.ZIP     96/02/11  11:10:16    127418                                  /ON
  46.  
  47.  
  48. Note that AV will not do much good for multi-disc ZIP files.
  49.  
  50. Since AV is based on a library of routines that is no longer  supported,  newer
  51. ZIP versions (including those generated by some Windows managers) will  not  be
  52. read properly by this command.
  53.  
  54.  
  55. AV.DOC                                 2                           Apr 28, 1997
  56.  
  57. When viewing a screen's worth of information, you can typically choose among  a
  58. number of options including the following:
  59.  
  60.         PgUp    view the previous screen's worth
  61.         PgDn    view the next screen's worth
  62.         Home    top line
  63.         End     bottom line
  64.         Up      move the screen up one line
  65.         Down    move the screen down one line
  66.         Sort    change the sort order for this and subsequent files;
  67.                 you're prompted for "BY?" and you should enter either
  68.                 "-x" or "x" or press Esc to get out of this: the archive
  69.                 is reread after you ask to re-sort it; x is one of:
  70.                         N = file name
  71.                         E = file extension
  72.                         S = file size of the original (non-compressed) file
  73.                         C = current (compressed) size of the file
  74.                         D = file date and time
  75.                         R = compression ratio
  76.                         P = path and file name order
  77.                         O = original order (no sorting)
  78.                 the "-" says to reverse the sort order (for example, biggest
  79.                 files first instead of last)
  80.         Filter  prompts you for a string; only member names that match that
  81.                 string are allowed through (does not accept wildcards; just say
  82.                 something like "COM" if you want all COM files)
  83.         Ctrl-PgDn go to the next archive file (if any)
  84.         Ctrl-PgUp go to the previous archive file (if any)
  85.         Quit    return to DOS (Ctrl-C also works) (with confirmation)
  86.         Date    update the archive file date to be the creation date of the
  87.                 most recent member in the archive; not offered if it's already
  88.                 the case
  89.         Del     delete the archive (with confirmation)
  90.         F1      help information
  91.         Alt-E   toggles between 25-line and 43-/50-line mode (if your
  92.                 system supports EGA and VGA respectively)
  93.  
  94. These options are presented on the right side of the screen and can be selected
  95. with the mouse cursor if one is available.
  96.  
  97.  
  98. Specifying parameters:
  99.  
  100. Parameters for this program can be set in the following ways.  The last setting
  101. encountered always wins:
  102.   - Read from an *.INI file (see BRUCEINI.DOC file),
  103.   - Through the use of an environmental variable (SET AV=whatever), or
  104.   - From the command line (see "Syntax" below)
  105.  
  106.  
  107.  
  108. AV.DOC                                 3                           Apr 28, 1997
  109.  
  110. Syntax:
  111.  
  112.     AV [ filespec ] [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /-MOUSE ]
  113.       [ /Tpath ] [ /Q ] [ /EGA | /VGA ]
  114.       [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ] [ > filename ]
  115.  
  116. where:
  117.  
  118. "filespec" is the file specification to process.  Can include drive, path,  and
  119. wildcards if desired.  If no input filespec is provided, you'll be prompted for
  120. one.
  121.  
  122. "/P" (or "/PAUSE") says to view the directory in page mode.  This is  typically
  123. the default.  The default is automatically /-P (which can't be  overridden)  if
  124. redirection ("AV ...  > filename") is used.
  125.  
  126. "/-P" (or "/-PAUSE") says to  view  the  directory  not  in  page  mode.   This
  127. prevents you from being offered the fix-date option  as  well.   This  mode  is
  128. automatic if redirection ("AV ...  > filename") is used.
  129.  
  130. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x" can
  131. be one of the following:
  132.  
  133.         N = file name
  134.         E = file extension
  135.         D = file date and time
  136.         S = file size of the original (non-compressed) file
  137.         C = current (compressed) size of the file
  138.         R = compression ratio
  139.         P = path and file name order
  140.         O = original order (no sorting)
  141.  
  142. If you precede the "x" with a dash ("-"), the sort  will  be  done  in  reverse
  143. order.  Initially defaults to /OO.
  144.  
  145. "/DATE" resets the archive file date to be the date of the most recent  member.
  146. Automatically invokes /-P.  The command "AV *.* /DATE /Q" is  a  quick  way  to
  147. reset the file date stamps for all archives in your current subdirectory.
  148.  
  149. "/MOUSE" says to activate the mouse if present.  This is initially the default.
  150.  
  151. "/-MOUSE" says to skip activating the mouse even if present.
  152.  
  153. "/Tpath" specifies where to write the temporary ISAM  files  that  the  routine
  154. needs.  ISAM data bases are used to store and sort the file names.  ISAM  files
  155. cannot be created reliably on certain types of drives.  Examples are "/TC:" and
  156. "/TC:\TEMP".  If  not  specified,  the  routine  writes  to  the  following  in
  157. sequence:
  158.  
  159.   - the value of any TEMP, then TMP, environmental variable
  160.   - C:\TEMP
  161.   - C:\
  162.  
  163. "/Q" skips the display of the member names.  Automatically  invokes  /DATE  and
  164. /-P and is typically used in cases where you want to reset all file dates  (for
  165. example, "AV *.* /Q").
  166.  
  167.  
  168. AV.DOC                                 4                           Apr 28, 1997
  169.  
  170. "/EGA" or "/VGA" will put you in 43/50-line mode if your monitor supports this.
  171. The two options are actually synonymous  (you'll  get  the  best  your  monitor
  172. supports).  You can also switch to and from 25-line and 43/50-line mode  within
  173. the program by using Alt-E.
  174.  
  175. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  176. defaults to "/COLOR".
  177.  
  178. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  179. initially the default.
  180.  
  181. "/Iinitfile" says to read an initialization file with the file name "initfile".
  182. The file specification *must* contain a period.  Initfiles are described in the
  183. BRUCEINI.DOC file.  Initially defaults to "/IAV.INI".
  184.  
  185. "/-I" (or "/INULL") says to skip loading the initialization file.
  186.  
  187. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  188. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  189. more information.  This is initially the default.
  190.  
  191. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  192. Initially defaults to "/ENV".
  193.  
  194. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  195.  
  196. ">filename" redirects the output to a text file.   This  automatically  invokes
  197. the /-P option.  This is useful for getting a complete listing of the  contents
  198. of your compressed files.  For example:
  199.  
  200.         AV *.* > TEMP.TXT
  201.  
  202.  
  203. Return codes:
  204.  
  205. AV returns the following ERRORLEVEL codes:
  206.  
  207.         0 = no problems
  208.       252 = other problems
  209.       253 = no valid archives were found
  210.       254 = could not find a decent temporary output subdirectory
  211.       255 = syntax problems, file not found, or /? requested
  212.  
  213.  
  214.  
  215. AV.DOC                                 5                           Apr 28, 1997
  216.  
  217. Author:
  218.  
  219. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  220. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  221. program, no changes are made to the program or documentation,  and  it  is  not
  222. bundled with commercial programs or charged for separately.  People who need to
  223. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  224. Software" at the following address.
  225.  
  226. Additional information about this and other  Wayne  Software  programs  can  be
  227. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  228. The recent change history for this and the other programs is  provided  in  the
  229. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  230. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  231. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  232. naming the ZIP file (AVymm.ZIP) that this program was included in.
  233.  
  234. Comments and suggestions can also be sent to:
  235.  
  236.                 Bruce Guthrie
  237.                 Wayne Software
  238.                 113 Sheffield St.
  239.                 Silver Spring, MD 20910
  240.  
  241.                 fax: (301) 588-8986
  242.                 e-mail: bguthrie@nmaa.org
  243.                 http://www.geocities.com/SiliconValley/Lakes/2414
  244.  
  245. Please provide an Internet e-mail address on all correspondence.
  246.  
  247. 
  248.